Skip to main content
Version: 5.1.1.0

Service Client

Purpose​

Service declaration, as one of the crucial concepts of Orchestra, is used either to expose an interface to the external world (server mode) or to use interfaces available outside of Orchestra (client mode). Note that when a service declaration is used in server mode, you also have to implement the service declaration in the Service Provider. However, we are using service declaration in most cases when we want to create a service client.

Creation​

In order to manually create a Service Client:

  1. Click on the plus icon located on the bottom-left of the screen.

  2. Select Services.

  3. Select Service Client.

  4. The configuration panel for the new service client is available on the right side.

Importing WSDL​

An alternative and more convenient way to create a service declaration (compared to manual creating) is to import a WSDL file. Importing WSDL will not only create the service declaration, but will also create message types and XML Schema based on the WSDL. Additionally, methods and bindings that are defined within WSDL will be created with settings you choose.

To import WSDL:

  1. Click on the plus icon located on the bottom-left of the screen.

  2. Select 'Import'.

  3. Select 'Service Declaration - WSDL Import'.

  4. Select a WSDL file.

    Note: that WSDL import can be done both from file and from URL

  5. In 'Service', users can specify Service and Port type to be used:

  6. Add the title of the Service Client, select 'Create new' and click import.

Creation of message types, XML Schema, and environment entries is done automatically. If you look on the left-side panel, the following is shown:

All methods defined in WSDL are created and also bindings that use the methods. Details can be found in Methods and Bindings sections.

Overwriting an existing WSDL​

To overwrite an existing WSDL:

  1. Click on the plus icon located on the bottom-left of the screen.

  2. Select 'Import'.

  3. Select 'Service Declaration - WSDL Import'.

  4. Select a WSDL file.

    Note: that WSDL import can be done both from file and from URL

  5. In 'Service', users can specify Service and Port type to be used:

  6. Enter a title for the Service Client, check Overwrite, expand the dropdown menu, and select the Service Client to be overwritten.

  7. Click Import.

See also​